| Conditions | 17 |
| Total Lines | 113 |
| Lines | 0 |
| Ratio | 0 % |
| Tests | 0 |
| CRAP Score | 306 |
| Changes | 12 | ||
| Bugs | 0 | Features | 0 |
Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.
For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.
Commonly applied refactorings include:
If many parameters/temporary variables are present:
Complex classes like _generate_triggers() often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
| 1 | # ~*~ coding: utf-8 ~*~ |
||
| 42 | def _generate_triggers(osmalchemy, osmcachedquery, maxage=60*60*24): |
||
| 43 | """ Generates the triggers for online functionality. |
||
| 44 | |||
| 45 | osmalchemy - reference to the OSMAlchemy instance to be configured |
||
| 46 | maxage - maximum age of objects before they are updated online, in seconds |
||
| 47 | """ |
||
| 48 | |||
| 49 | _visited_queries = WeakSet() |
||
| 50 | |||
| 51 | @listens_for(osmalchemy.node, "load") |
||
| 52 | @listens_for(osmalchemy.way, "load") |
||
| 53 | @listens_for(osmalchemy.relation, "load") |
||
| 54 | def _instance_loading(target, context, _=None): |
||
| 55 | # Get query session |
||
| 56 | session = context.session |
||
| 57 | |||
| 58 | # Skip if the session was in a trigger before |
||
| 59 | # Prevents recursion in import code |
||
| 60 | if hasattr(session, "_osmalchemy_in_trigger"): |
||
| 61 | return |
||
| 62 | |||
| 63 | # Check whether object needs to be refreshed |
||
| 64 | updated = target.osmalchemy_updated |
||
| 65 | timediff = datetime.datetime.now() - updated |
||
| 66 | if timediff.total_seconds() < maxage: |
||
| 67 | return |
||
| 68 | |||
| 69 | # Determine OSM element type and id |
||
| 70 | type_ = target.__class__.__name__[3:].lower() |
||
| 71 | id_ = target.id |
||
| 72 | |||
| 73 | # Guard against broken objects without an id |
||
| 74 | if id_ is None: |
||
| 75 | return |
||
| 76 | |||
| 77 | # Get object by id as XML |
||
| 78 | xml = _get_single_element_by_id(osmalchemy._overpass, type_, id_) |
||
| 79 | |||
| 80 | # Import data |
||
| 81 | session._osmalchemy_in_trigger = True |
||
| 82 | _import_osm_xml(osmalchemy, session, xml) |
||
| 83 | del session._osmalchemy_in_trigger |
||
| 84 | |||
| 85 | @listens_for(Query, "before_compile") |
||
| 86 | def _query_compiling(query): |
||
| 87 | # Get the session associated with the query: |
||
| 88 | session = query.session |
||
| 89 | |||
| 90 | # Skip if the session was in a trigger before |
||
| 91 | # Prevents recursion in import code |
||
| 92 | if hasattr(session, "_osmalchemy_in_trigger"): |
||
| 93 | return |
||
| 94 | |||
| 95 | # Prevent recursion by skipping already-seen queries |
||
| 96 | if query in _visited_queries: |
||
| 97 | return |
||
| 98 | else: |
||
| 99 | _visited_queries.add(query) |
||
| 100 | |||
| 101 | # Check whether this query affects our model |
||
| 102 | affected_models = set([c["type"] for c in query.column_descriptions]) |
||
| 103 | our_models = set([osmalchemy.node, osmalchemy.way, osmalchemy.relation, |
||
| 104 | osmalchemy.element]) |
||
| 105 | if affected_models.isdisjoint(our_models): |
||
| 106 | # None of our models is affected |
||
| 107 | return |
||
| 108 | |||
| 109 | # Check whether this query filters elements |
||
| 110 | # Online update will only run on a specified set, not all data |
||
| 111 | if query.whereclause is None: |
||
| 112 | # No filters |
||
| 113 | return |
||
| 114 | |||
| 115 | # Analyse where clause looking for all looked-up fields |
||
| 116 | trees = {} |
||
| 117 | for target in our_models.intersection(affected_models): |
||
| 118 | # Build expression trees first |
||
| 119 | tree = _where_to_tree(query.whereclause, target) |
||
| 120 | if not tree is None: |
||
| 121 | trees[target.__name__] = tree |
||
| 122 | |||
| 123 | # Bail out if no relevant trees were built |
||
| 124 | if not trees: |
||
| 125 | return |
||
| 126 | |||
| 127 | # Compile to OverpassQL |
||
| 128 | oql = _trees_to_overpassql(trees) |
||
| 129 | |||
| 130 | # Look up query in cache |
||
| 131 | hashed_oql = hash(_normalise_overpassql(oql)) |
||
| 132 | cached_query = session.query(osmcachedquery).filter_by(oql_hash=hashed_oql).scalar() |
||
| 133 | # Check age if cached query was found |
||
| 134 | if cached_query: |
||
| 135 | timediff = datetime.datetime.now() - cached_query.oql_queried |
||
| 136 | if timediff.seconds < maxage: |
||
| 137 | # Return and do nothing if query was run recently |
||
| 138 | return |
||
| 139 | |||
| 140 | # Run query online |
||
| 141 | xml = _get_elements_by_query(osmalchemy._overpass, oql) |
||
| 142 | |||
| 143 | # Import data |
||
| 144 | session._osmalchemy_in_trigger = True |
||
| 145 | _import_osm_xml(osmalchemy, session, xml) |
||
| 146 | del session._osmalchemy_in_trigger |
||
| 147 | |||
| 148 | # Store or update query time |
||
| 149 | if not cached_query: |
||
| 150 | cached_query = osmcachedquery() |
||
| 151 | cached_query.oql_hash = hashed_oql |
||
| 152 | cached_query.oql_queried = datetime.datetime.now() |
||
| 153 | session.add(cached_query) |
||
| 154 | session.commit() |
||
| 155 |